home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr29 / game02a.zip / GAMEDD.DOC < prev    next >
Text File  |  1995-01-18  |  15KB  |  367 lines
  1. Advanced OS/2 Joystick Device Driver - Version 0.2a
  2. Copyright 1995 Robert J. Manley and Multi-Player Computer Adventures
  3. SHAREWARE - please read the REGISTRATION section for details.
  4.  
  5.  
  6. BRIEF
  7.   The Advanced OS/2 Joystick Device Driver has two main purposes:
  8.     * To eliminate the joystick response 'flicker' effect seen in many
  9.       DOS games running under OS/2.
  10.     * To provide a standard interface for OS/2 game programmers to use
  11.       the PC joystick port in their products.
  12.  
  13.       >> Please note that there are also plans to allow DOS applications
  14.          to speak with the driver, allowing DOS games running under OS/2
  15.          very efficient and reliable readings of the joystick port.
  16.  
  17. NOTE!!
  18.   The shareware version of this driver will work exactly as the registered
  19.   version.  However, the shareware driver will disable its functionality
  20.   after 3 uses (eg. after you run three games).  Although the driver will
  21.   no longer be active, the game port will still be accessible, thus games
  22.   and other programs will run as if the driver were not installed.  This should
  23.   give you enough time to evaluate the driver and decide whether or not it will
  24.   be useful for you.  Rebooting your system will reset the driver's usage
  25.   count, so you can play with things a bit more after doing so.  PLEASE
  26.   REGISTER THIS SOFTWARE!
  27.  
  28.  
  29. CONTENTS
  30.   1. Installation
  31.   2. Usage
  32.   3. Legal Note
  33.   4. Registration
  34.   5. Known Compatibility List
  35.   6. Known Bugs and Limitations
  36.   7. Q&A
  37.   8. Contacting the Author
  38.   9. Closing Notes
  39.  10. History
  40.  
  41. // 1. INSTALLATION
  42.  
  43.  
  44.    PLEASE NOTE: If you've installed an older version of this driver (0.1a),
  45.                 you will have to delete the GAMEDD.SYS, GAMEVDD.SYS and
  46.                 GAMEDD.DOC files from your \OS2 directory manually.  Also,
  47.                 please remove references to these drivers from your CONFIG.SYS.
  48.  
  49.  
  50.    A. "AUTOMATIC" installation.
  51.  
  52.        The device driver can be installed using the OS/2 device
  53.        driver installer.  Follow these steps:
  54.  
  55.       - If you received the joystick driver as a ZIP file, extract it
  56.         into a temporary directory.
  57.  
  58.       - Open your OS/2 System Setup folder and execute 'Device Driver Install',
  59.         or type 'DDINSTAL' at an OS/2 command prompt.
  60.  
  61.       - Change the SOURCE DIRECTORY entry to match the directory in which the
  62.         joystick driver is located.
  63.  
  64.       - The DESTINATION DIRECTORY should match the root directory of your
  65.         OS/2 boot drive.
  66.  
  67.       - When you click on the INSTALL button, the Advanced OS/2 Joystick
  68.         Driver should appear in a list box.
  69.  
  70.       - Select the driver by clicking on its name, then click the OK button.
  71.         This will copy the device driver files into a directory named MPCA on
  72.         the root of your boot drive and add the device driver loading lines to
  73.         your CONFIG.SYS
  74.  
  75.       - You can now exit the Device Driver Install program and reboot
  76.         your OS/2 system to enable the driver.
  77.  
  78.    B. "MANUAL" installation.
  79.  
  80.       - Create a directory on the root of your boot drive named MPCA.
  81.  
  82.       - If you received the joystick driver as a ZIP file, extract it
  83.         into a the MPCA directory, otherwise, copy all the driver files
  84.         into that directory.
  85.  
  86.       - Add the following lines to your CONFIG.SYS file:
  87.  
  88.         DEVICE=x:\mpca\gamedd.sys
  89.         DEVICE=x:\mpca\gamevdd.sys
  90.  
  91.         (replacing 'x' with the letter of your boot drive, of course)
  92.  
  93.       - Reboot your system to enable the driver.
  94.  
  95.  
  96. // 2. USAGE
  97.  
  98.    The driver adds two options to your DOS SETTINGS notebook.
  99.    To change these options, simply bring up the settings notebook
  100.    for a particular DOS session icon, choose the SESSION tab, and click
  101.    on the DOS SETTINGS button.
  102.  
  103.    GAME_DIRECT_ACCESS
  104.  
  105.     ON - This setting essentially disables the driver by giving the
  106.              DOS program direct access to the game port.  You should only
  107.              enable this setting if you're having problems with control
  108.              of a DOS game and suspect that the joystick driver may be
  109.              at fault.  This is also useful for testing the difference
  110.              between having the driver enabled and disabled for a particular
  111.              game.
  112.  
  113.        OFF - The default setting.  This prevents the DOS program from talking
  114.              directly to the game port, and thus allows the joystick driver
  115.              to do its work.
  116.  
  117.    GAME_DIGITAL_RESPONSE
  118.  
  119.         ON - The default setting.  When this option is enabled, the driver
  120.              reports information back to the DOS program which makes your
  121.              joystick look much like a GamePad, even if your joystick
  122.              is analog.
  123.  
  124.        OFF - Analog joysticks will look like analog joysticks ...
  125.  
  126.  
  127.    MANUAL RESPONSE SETTINGS ADJUSTMENT 
  128.  
  129.     The values that the driver returns to the application using it
  130.     can be manually adjusted in case of unusual behavior.  For example,
  131.     some games may act as if the joystick is being held constantly toward
  132.     one direction.  If this happens, switch out of the running DOS
  133.     application (by using CTRL-ESC, for example) and execute the
  134.     JOYTUNE.EXE program found in the MPCA subdirectory.
  135.  
  136.     The program will display the values the joystick driver currently
  137.     responds with when in DIGITAL RESPONSE mode.  If you choose to change
  138.     these values, you will be prompted first for X-axis values, followed
  139.     by Y-axis values.  Enter three numbers for each axis, representing
  140.     the values which should be returned to the game or application.
  141.  
  142.     Modifying these values may improve or resolve odd joystick response
  143.     problems.  For example, if your program acts as if the joystick
  144.     is being held constantly towards the upper-left, then values the
  145.     joystick driver is returning for the 'centered' position are too
  146.     low for both axis.  Try raising the middle value for each axis using
  147.     JOYTUNE.  You'll likely need to adjust the other values as well.
  148.     In most cases, you'll be able to simply switch back and forth between
  149.     the game you're trying to use and the JOYTUNE program until the
  150.     adjustment is refined.
  151.  
  152.     There are plans for a more user-friendly version of JOYTUNE soon,
  153.     which would include the ability to save your modifications for
  154.     future use.
  155.         
  156. // 3. LEGAL NOTE
  157.  
  158.    This software is provided AS IS.  No warranty of any kind, expressed or
  159.    implied, is granted including any warranties of quality or fitness for
  160.    a particular purpose.  Under no circumstances will either Robert J. Manley,
  161.    Multi-Player Computer Adventures, or Oscar Fowler be held responsible for
  162.    any damage that results directly or indirectly from the use of this product.
  163.  
  164.  
  165. // 4. REGISTRATION
  166.  
  167.    Registration entitles you to legally use this and all future versions
  168.    of the Advanced OS/2 Joystick Device Driver.  You will be sent an access
  169.    code which will remove the 3-use limit of the shareware driver.
  170.  
  171.    Please fill in the following information and send it along with a check
  172.    or money order for $15.00 US to:
  173.  
  174.    (Make checks payable to Oscar M. Fowler)
  175.  
  176.     Multi-Player Computer Adventures
  177.         c/o
  178.         Oscar Fowler
  179.         1834 East Seventh Street
  180.     Tucson, Arizona 85719-5511
  181.         USA
  182.  
  183.    name: _____________________________________________________________
  184.  
  185.  e-mail: _____________________________________________________________
  186. (Important!  We'll send your access code via email, if possible.)
  187.  
  188. company: _____________________________________________________________
  189.  
  190. address: _____________________________________________________________
  191.  
  192.        : _____________________________________________________________
  193.  
  194.        : _____________________________________________________________
  195.  
  196.   phone: _____________________________________________________________
  197.  
  198.              cpu type: ________________       cpu speed: _____________
  199.  
  200.          os/2 version: ________________________
  201.  
  202. type of joystick port: _______________________________________________
  203.  
  204.      type of joystick: _______________________________________________
  205.  
  206.                notes:  _______________________________________________
  207.  
  208.                        _______________________________________________
  209.  
  210.        
  211.    NOTE:  If you are a *registered* user of Robert Manley's Gravis
  212.           UltraSound driver for OS/2, you are automatically registered to use
  213.           the joystick driver.  The serial number on your GUS driver diskette
  214.           is used for your joystick driver registration.
  215.  
  216. Some future versions of this product may only be distributed commercially
  217. but will be sent free to all registered users.
  218.  
  219.  
  220. // 5. KNOWN COMPATIBILITY LIST
  221.  
  222.    The following is a list of games which have been tested with this
  223.    driver.  We may expand this list as more information becomes available,
  224.    so please let us know what *your* results are.
  225.  
  226.    PLEASE NOTE THAT DUE TO DIFFERENCES IN SYSTEM HARDWARE, YOUR RESULTS
  227.    *MAY* BE DIFFERENT FROM THOSE SHOWN HERE!  (YMMV)
  228.  
  229.  
  230. GAME                    VER.   RATING    NOTES
  231. ------------------------------------------------------------------------------
  232. Alien Carnage        1.0    0    Plays well w-w/o driver.
  233. Boppin            1.1    0    Useless w-w/o driver.
  234. Commander Keen        4    2
  235. Doom II            1.7    0    Locks up w-w/o driver.
  236. Falcon            3.0    2    Was ok before - solid now.
  237. Jazz Jackrabit        1.0    2
  238. Line Wars II        1.04    2    Solid.  Some flicker before.
  239. Lion King        NA    2
  240. Magic Carpet        NA    2
  241. MS Flight Simulator    5.0a    1    Better, but still some flicker.
  242. Mortal Kombat        1.0    0    Useless w-w/o driver.
  243. One Must Fall        1.0    2
  244. Rampart            NA    2
  245. Raptor            1.0    2
  246. Star Control II        NA    2    Unusable before - great now.
  247. SVGA Air Warrior    1.16b    -1    Flicker worse with than without.
  248. Tie Fighter        NA    2
  249. X-Wing 1 (3.5")        NA    2
  250.  
  251. NOTES
  252. ---------------------
  253. +2. Works solidly now - had problems without driver.
  254. +1. Some improvement - game is better with driver, but still has problems.
  255.  0. Driver provided no noticeable improvement.
  256. -1. Game works somewhat better *without* the driver.
  257. -2. Driver makes the game unplayable, works much better without it.
  258.  
  259.  
  260. // 6. KNOWN BUGS AND LIMITATIONS
  261.  
  262.    There are currently no known bugs with the driver itself.
  263.  
  264.    There seems to be a limitation in the number of option settings which
  265.    can be added to the DOS SETTINGS notebook.  If nothing happens when
  266.    you click on the DOS SETTINGS button, then you've most likely run into
  267.    this limitation.  Our only suggestion at this point is that you
  268.    remove other virtual device drivers which add options to this notebook
  269.    from your CONFIG.SYS.  If you're using Ray Gwinn's SIO driver but
  270.    don't have any DOS programs which really need it, then the VSIO.SYS
  271.    virtual device driver is a good candidate since it adds *many* options
  272.    to the notebook.
  273.  
  274.    The following is a list of games which will *not* work with joystick
  275.    support under OS/2 at all.  Unfortunately, the driver can't do anything
  276.    about fixing these problems.  Since the great majority of games *do*
  277.    work with a joystick under OS/2, we suggest you contact the authors of
  278.    the game in question and ask them to fix the problem.  Given enough such
  279.    requests, it is possible that they may actually do something about it.
  280.  
  281.     DOOM II: The game will simply stop at its title screen if you
  282.                  configure it for joystick use.  No amount of coaxing seems
  283.                  to change its mind.  Considering that sound effects don't
  284.                  work under OS/2 either, it almost seems as if Id is
  285.                  purposefully trying to make life difficult for OS/2 users ...
  286.  
  287. // 7. Q&A
  288.  
  289.    Q: Does this driver add extra overhead to my OS/2 system?
  290.    A: The driver needs to poll the game port for new joystick information.
  291.       However, it only does this when an application (game) is using it and
  292.       is idle otherwise.
  293.  
  294.    Q: Will this driver conflict with the WatchCat monitor program?
  295.    A: No.  Be aware that WatchCat will still be checking the joystick
  296.       buttons, though, even while games are running.  We suggest you start
  297.       WatchCat with the /GA option, which would require you to press all
  298.       joystick buttons simultaneously to start WatchCat.  Alternately,
  299.       you could disable WatchCat before starting a game and re-enable it
  300.       afterwards using the TOGGLE option.  Check the WatchCat documentation.
  301.       Please note that WatchCat 2.0 does not have an option equivalent to
  302.       the /GA in previous versions.  The authors are aware of this and
  303.       said they would add it again in a later release.
  304.  
  305.    Q: Doom II just locks up at the title screen!  What's wrong?
  306.    A: Read the KNOWN BUGS AND LIMITATIONS section above.
  307.  
  308.    Q: Nothing happens when I click on the DOS SETTINGS button!  What's wrong?
  309.    A: Read the KNOWN BUGS AND LIMITATIONS section above.
  310.  
  311.    Q: Will the driver work with the XYZ joystick??
  312.    A: The driver is not designed to work with a particular kind of joystick.
  313.       It simply reads the joystick *port* for position information and
  314.       feeds that back to the DOS program at the appropriate time.  It is then
  315.       up to your program to interpret the data correctly.  If you're having
  316.       problems with a particular kind of joystick, please contact us
  317.       at the address below.
  318.  
  319.    Q: Will this driver only work with the Gravis UltraSound?
  320.    A: No.  It is a general-purpose driver which should work with
  321.       any standard game adapter.
  322.  
  323.    Q: Why don't the driver's DOS SETTINGS have descriptions in the settings
  324.       notebook?
  325.    A: It appears to be impossible for third-party virtual device drivers
  326.       to add descriptions to their settings within the DOS SETTINGS notebook.
  327.       Bug IBM about it!
  328.  
  329.  
  330. // 8. CONTACTING THE AUTHOR
  331.  
  332.    Robert J. Manley is the author of the Advanced OS/2 Joystick Device
  333.    Driver.  However, Oscar Fowler is handling registration and distribution
  334.    of the driver.  If you have any questions or comments, please contact
  335.    him at any of the following addresses:
  336.  
  337.     Oscar Fowler
  338.     1834 East Seventh Street
  339.     Tucson, AZ 85719-5511 (USA)
  340.  
  341.     Internet email: oscar@cs.arizona.edu
  342.                                or
  343.                         omf@rightfax.com
  344.  
  345.     CompuServe: 72347,1655 (not checked often - you'll get a quicker
  346.                                 response from one of the other addresses above)
  347.  
  348. // 9. CLOSING NOTES
  349.  
  350.    This driver was written because many OS/2 users complained about joystick
  351.    flickering in DOS games.  In other words - it was written for you!
  352.    We hope it makes your use of OS/2 more enjoyable.  Please contact us
  353.    with any suggestions or comments.
  354.  
  355.    Enjoy!
  356.  
  357. // 10. HISTORY
  358.  
  359.    Ver 0.1a [12/94]
  360.     First public release.
  361.  
  362.    Ver 0.2a [01/95]
  363.     Game port polling increased to improve responsiveness.
  364.     OS/2 API specifications released.
  365.         Possible bug fixed which caused flicker every minute or so.
  366.     Digital response tuning app. introduced.
  367.